home *** CD-ROM | disk | FTP | other *** search
/ BBS in a Box 5 / BBS in a Box -Volume V (BBS in a Box) (April 1992).iso / Files / Apple / Apple II TNs(Text).cpt / Apple II TNs(Text) / PDOS / TN.PDOS.016 / TN.PDOS.016
Encoding:
Text File  |  1989-11-15  |  2.9 KB  |  61 lines  |  [TEXT/pdos]
  1. Apple II
  2. Technical Notes
  3. _____________________________________________________________________________
  4.                                                   Developer Technical Support
  5.  
  6.  
  7. ProDOS 8
  8. #16:    How to Format a ProDOS Disk Device
  9.  
  10. Revised by:    Matt Deatherage                                  November 1988
  11. Revised by:    Pete McDonald                                    November 1985
  12.  
  13. This Technical Note supplements the ProDOS 8 Technical Reference Manual in its 
  14. description of the low-level driver call that formats the media in a ProDOS 
  15. device.
  16. _____________________________________________________________________________
  17.  
  18. The ProDOS 8 Technical Reference Manual describes the low-level driver call 
  19. that formats the media in a ProDOS device, but it neglects to mention the 
  20. following:
  21.  
  22. 1.    It does not work for Disk II drives or /RAM, both of which ProDOS 
  23.       treats specially with built-in driver code.
  24. 2.    ProDOS has no easy way to tell you whether a device is a Disk II 
  25.       drive or /RAM.
  26.  
  27. Once ProDOS finishes building its device table, which it does when it boots, 
  28. it no longer cares about what kind of devices exist, so it does not keep any 
  29. information about the different types of devices available.  ProDOS identifies 
  30. Disk II devices and installs a built-in driver for them.  When it has 
  31. installed all devices which are physically present, ProDOS then installs /RAM, 
  32. in a manner similar to Disk II drives, by pointing to the driver code which is 
  33. within ProDOS itself.  This method presents a problem for the developer who 
  34. wishes to format ProDOS disks since the Disk II driver and the /RAM driver 
  35. respond to the FORMAT request in non-standard ways, yet there is no 
  36. identification in the global page that tells you which devices are Disk II 
  37. drives or /RAM.
  38.  
  39. The Disk II driver does not support the FORMAT request, and the /RAM driver 
  40. responds by "formatting" the RAM disk and also writing to it a virgin 
  41. directory and bitmap; neither of these two cases is documented in the ProDOS 8 
  42. Technical Reference Manual.  To write special-case code for these two device 
  43. types, you must be able to identify them, and the method for identification is 
  44. available in ProDOS 8 Technical Note #21:  Identifying ProDOS Devices.
  45.  
  46. You should note, however, that AppleTalk network volumes cannot be formatted; 
  47. they return a DEVICE NOT CONNECTED error for the FORMAT and any low-level 
  48. device call.  You may access AppleTalk network volumes through ProDOS MLI 
  49. calls only.
  50.  
  51. Also note that Apple licences a ProDOS 8 Formatter routine, which correctly 
  52. identifies and handles Disk II drives and /RAM.  You should contact Apple 
  53. Software Licensing at Apple Computer, Inc., 20525 Mariani Avenue, M/S 38-I, 
  54. Cupertino, CA, 95014 or (408) 974-4667 if you wish to license this routine.
  55.  
  56.  
  57. Further Reference
  58. o    ProDOS 8 Technical Reference Manual
  59. o    ProDOS 8 Update Manual
  60. o    ProDOS 8 Technical Note #21, Identifying ProDOS Devices
  61.